home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / EDUCUAGE / ULTIFRNC.LZH / TEACHER.DOC < prev    next >
Text File  |  1991-09-12  |  27KB  |  545 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                            Ultimate Language Teacher
  20.  
  21.                           A Foreign Language Teacher
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                                                                 Distributed by:
  47.  
  48.                                                               Ultimate Software
  49.                                                                  P. O. Box 2454
  50.                                                           White City, OR  97503
  51.                                                                  (503) 830-0501
  52.  
  53.                        Programming by Richard W. Watson
  54.  
  55.              Documentation by Richard W. Watson and Tom Knackstedt
  56.  
  57.                          Copyright and distribution by
  58.                                Ultimate Software
  59.                                 P. O. Box 2454
  60.                              White City, OR 97503
  61.                             (503) 830-0501 (voice)
  62.  
  63.  
  64. Program and Documentation Copyright 1991 Ultimate Software.  All rights
  65. reserved.
  66.  
  67.  
  68. Ultimate Language Teacher is a trademark of Ultimate Software.
  69. PC, PC XT, PC AT, PS/2 are trademarks of IBM Corporation.
  70.  
  71.  
  72.  
  73.                                ACKNOWLEDGEMENTS
  74.  
  75.  
  76. We at Ultimate Software couldn't possibly produce products like this one
  77. without help.  We would like to thank the following people:
  78.  
  79.      A special thanks to Mike for making this all possible.
  80.      To Pat who has listened even when she had no idea what I was talking
  81.      about, or why.
  82.      To Tom for his excellent beta testing and advice.
  83.      To Thomas for taking over my other responsibilities.
  84.      To Mike Smedley and SoftC, Ltd. who developed The C Extended Library and
  85.           The SoftC Database Library that made coding so much easier.
  86.  
  87.  
  88.  
  89. The following tools were used in creating this software:
  90.      
  91.      Compilers:          Borland C++ 2.00, and Borland Assembler 2.0.
  92.      Libraries:          The C Extended Library from Mike Smedley and
  93.                          TesSeRact, SoftC Database Library from SoftC, Ltd.
  94.      Debuggers:          Borland Turbo Debugger 2.0, and Borland C++
  95.                          Interactive Development Environment.
  96.  
  97.  
  98. TABLE OF CONTENTS
  99.  
  100.      Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
  101.      Registration Information                                                 1
  102.      License Agreement. . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
  103.      Technical Support                                                        4
  104.      Program Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
  105.      Installation                                                             5
  106.      Execution  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  107.           Main Menu                                                           6
  108.                Test Menu  . . . . . . . . . . . . . . . . . . . . . . . . . . 6
  109.                Libraries                                                      7
  110.                People . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
  111.                     Add a Person                                              8
  112.                     Remove a Person . . . . . . . . . . . . . . . . . . . . . 8
  113.                     See Scores                                                8
  114.                     Graph Scores. . . . . . . . . . . . . . . . . . . . . . . 8
  115.                Register                                                       9
  116.      
  117. Introduction                                                            Page 1
  118.  
  119.      Welcome, and thank you for trying the Ultimate Language Tutor.
  120.  
  121.      The Ultimate Language Tutor was designed to help you learn words from
  122.      foreign languages like Spanish, French and German through quizzing.
  123.  
  124.      You'll find the Ultimate Language Tutor has a wide array of quizzing
  125.      features and is very expandable through its library system.
  126.  
  127.      The Ultimate Language Tutor is being distributed through Shareware, which
  128.      allows you to test out a program before purchasing it.  Further
  129.      explanation of Shareware and Registration can be found on this page.
  130.  
  131.      In the following pages you will learn how to install and use The Ultimate
  132.      Language Tutor to its full benefit.
  133.  
  134.      The ASCII test found in this "electronic" manual are only slightly
  135.      different from the printed manual.  The printed manual is written around
  136.      the concept that you are a registered user.
  137.  
  138. Registration Information
  139.  
  140.      The Ultimate Language Tutor is a copyrighted program protected by all
  141.      applicable U.S. and International copyright laws.  If you have obtained
  142.      this copy from a shareware disk vendor, an on-line computer service or
  143.      bulletin board, a friend or colleague, or any similar source, you have the
  144.      trial (unregistered) copy.  You are allowed to use this copy without
  145.      charge for a limited time as specified under the license agreement.  After
  146.      this time, you must register in order to continue using The Ultimate
  147.      Language Tutor legally.
  148.  
  149.      This method of distribution is known as Shareware, a distribution concept
  150.      began by Jim Button.  It allows you, as a user, to evaluate the software
  151.      in your own home to make sure it meets your needs before you pay for it.
  152.  
  153.      The registration fee for The Ultimate Language Tutor is only $20.  Payment
  154.      of this fee entitles you to:
  155.  
  156.           A disk with the latest version of The Ultimate Language Tutor,
  157.           registered directly to you.
  158.  
  159.           A program that will allow you to create your own (or modify existing)
  160.           libraries of words for use with this tutor.
  161.  
  162.           An upgrade to the next major release of The Ultimate Language Tutor.
  163.  
  164.           Technical Support via telephone or selected Electronic Bulletin
  165.           Boards.
  166.  
  167.           Notification of other programs within the Ultimate Software Library.
  168. Ultimate Language Tutor's License Agreement                             Page 2
  169.  
  170.      (1)  Copyright:  This program, documentation, and supplied libraries are
  171.      Copyright Ultimate Software 1991, and are protected by U.S. and
  172.      International copyright laws.  You are granted a license to use your copy
  173.      of The Ultimate Language Tutor under the terms and conditions specified in
  174.      this license agreement.
  175.  
  176.      (2)  Definitions:   The Ultimate Language Tutor is being distributed in
  177.      two forms: 1.  The "registered" copy being distributed on diskette from
  178.      Ultimate Software, with a unique serial number and the words "Registered
  179.      Version" appearing at the border of the "Program Description Window" and
  180.      on the diskette label.  2.  A "shareware" copy being distributed via
  181.      electronic bulletin boards, on-line services, shareware disk vendors, or
  182.      another individual.  This copy will have the words "UNREGISTERED VERSION"
  183.      appearing at the border of the "Program Description Window".
  184.  
  185.      (3)  Shareware Copies:  Shareware copies are distributed to allow you to
  186.      try the program before you pay for it.  These copies are still Copyright
  187.      Ultimate Software 1991.  These copies are not to be confused with "public
  188.      domain" or "free" software.  You are allowed to use the shareware copies
  189.      for a trial period of 30 days.  Once the trial period is over, you are
  190.      required to register with Ultimate Software for $20.
  191.      
  192.      (4)  Registered Copies:  Registered copies are only distributed to those
  193.      persons who have purchased them through Ultimate Software or an authorized
  194.      reseller.  You registered copies may only be used in accordance with the
  195.      License agreement and any additional specifications defined within
  196.      enclosed documents.  (In other words, for site licenses.)
  197.  
  198.      (5)  Use on Networks or Multiple Systems:  A site license agreement will
  199.      accompany your copy of the Ultimate Language Tutor if you have purchased
  200.      one.  The number of "users" permitted will be defined within this
  201.      document.  If you did not purchase a site license agreement, then you are
  202.      limited to one "user".
  203.  
  204.      (6)  User:  A computer on which the Ultimate Language Tutor is installed,
  205.      regardless of whether the user is aware of this installation.
  206.  
  207.      (7)  Copying the Ultimate Language Tutor:  
  208.           Registered Users:
  209.                You may make as many copies of the Ultimate Language Tutor as
  210.                you require for your own backup purposes.  No copies of the
  211.                REGISTERED version shall be distributed by you or anyone acting
  212.                in your behalf (employees, etc.) to anyone who has not purchased
  213.                the Ultimate Language Tutor.  You may create and distribute an
  214.                unlimited number of copies of the UNREGISTERED version(s) to
  215. License Agreement (continued)                                           Page 3
  216.                anyone you wish as long as the maximum billed amount does not
  217.                exceed $6.00 (US) for this program, documentation, and any other
  218.                "accompanying" parts related directly to this program.
  219.           Unregistered Users:
  220.                You may make as many copies of the UNREGISTERED version(s) to
  221.                give / distribute to anyone you wish as long as the maximum
  222.                billed amount does not exceed $6.00 (US) for this program,
  223.                documentation, or any other "accompanying" parts related
  224.                directly to this program.
  225.  
  226.      (8)  Distribution:  You MAY NOT attempt to distribute this program with
  227.      the intent of mass production for the public without prior written
  228.      permission by Ultimate Software.  You MAY create individual copies for
  229.      friends or associates for their individual use.  If you are a bulletin
  230.      board system or shareware disk vendor:  you may not distribute this
  231.      diskette without prior written permission of Ultimate Software unless you
  232.      are part of the Association of Shareware Professionals and are approved by
  233.      the ASP for distribution.
  234.  
  235.      (9)  Limited Warranty:  Ultimate Software warrants to the owners of
  236.      registered copies of the Ultimate Language Tutor that the software will
  237.      operate as described in the documentation, and that the diskette and
  238.      manual will be free of defects which interfere with normal use.  This
  239.      warranty is valid for 90 days from the date of purchase from Ultimate
  240.      Software.  During this warranty period Ultimate Software will at its
  241.      option repair or replace any defective item(s), or refund the purchase
  242.      price of any defective item(s), if such defect is found to be the fault of
  243.      Ultimate Software and not the result of misuse or abuse beyond "standard"
  244.      use.  In no event will Ultimate Software be held accountable for any
  245.      financial amount exceeding the purchase price of this package.
  246.  
  247.      (10)  Guarantees:  If you are not satisfied with the registered copy of
  248.      the Ultimate Language Tutor, you may return the entire package at any time
  249.      up to 90 days after the date of purchase to Ultimate Software for a full
  250.      refund.  This applies even if you have found no software defects.  
  251. Technical Support                                                       Page 4
  252.  
  253.      Technical support is available to registered users.  If you are evaluating
  254.      a shareware version of the Ultimate Language Teacher, we will be available
  255.      to answer questions about installation, however, we cannot provide
  256.      continuing support until you register.  We have found that most of the
  257.      questions asked can be answered in the documentation, so please be sure to
  258.      review all of the documentation before calling.
  259.  
  260.      The best way currently to contact us for support is by phone.  We are
  261.      considering setting up support areas on other Bulletin Board Systems;
  262.      however, this support is not currently in effect.  You can find our
  263.      telephone number at the beginning of this documentation.
  264.  
  265.  
  266. Program Features
  267.  
  268.      The Ultimate Language Tutor was written to help people studying a foreign
  269.      language by quizzing them on words listed in a library.  As the program
  270.      developed, more and more features were requested and eventually included. 
  271.      The list of features currently is as follows:
  272.  
  273.      Libraries segmented by Noun, Verb, Misc...:
  274.           It was determined that the new language was learned easiest when the
  275.           words were grouped into like areas, for instance, Nouns, Verbs,
  276.           Miscellaneous.  When these areas are reviewed, one could then move on
  277.           to learn phrases and verb conjugation.
  278.  
  279.      Keeping track of scores for people:
  280.           If you select the people menu, you can enter your name and set up
  281.           memory to track your testing scores.  At each test area, the computer
  282.           will ask you if you would like to test for a specific person. It will
  283.           then display a list of people it knows for your selection.  After the
  284.           test is complete, you can return to the people menu and view your
  285.           scores as a graph.  If you do not complete the test, the score will
  286.           not be kept.  If you change libraries, all the scores will be erased
  287.           and you begin tracking scores under the new library, unless you have
  288.           registered.  In the registered upgrade, the scores for any tests done
  289.           by a specific person will be tracked in the database.
  290.  
  291.      Easy access to libraries:
  292.           When you pick a library from the main menu, you will be presented
  293.           with a list of the libraries on the default drive.  Simply scroll
  294.           through this list and select the new library.  The new library will
  295.           be loaded, and you may test from it.
  296.  
  297.      Database tracking (added to the registered version):
  298.           When you have started a test, your name, date, time, and the library
  299.           name will be added to a database, along with the area you are
  300.           testing.  When you have completed your test, the database will be
  301.           updated.  This database is dBase III compatible and can be modified
  302.           through dBase III, dBase III+, dBase IV, FoxBase, FoxPro, PCFile or
  303.           any dBase program capable of handling dBase III data files.
  304. Program Features (continued)                                            Page 5
  305.      Reporting (added to the registered version):
  306.           The reporting functions allow you to report to disk, screen or any
  307.           standard printer.  The database can be sorted by Name, Library, or
  308.           Date.  Then there is a list of filtering functions so that you can
  309.           isolate one student, one library, a group or groups (nouns,
  310.           verbs...), a range of dates, or only completed tests.  These
  311.           functions were set up to allow you to view how you have been doing
  312.           since you started.  For instance, you could create a report of only
  313.           your name, in all libraries, tested after 06/30/91, for only
  314.           completed tests, and include only nouns and verbs.  This would let
  315.           you isolate only areas of the database you want to view.
  316.  
  317.      Library Builder (distributed with the registered version):
  318.           The library builder allows you to create customized libraries for use
  319.           with the Ultimate Language Teacher.  This can be of great help for
  320.           tests in school or even if you are about to head to a foreign country
  321.           and don't feel that the included libraries will be enough.  The
  322.           Library Builder will also allow you to create other language
  323.           libraries -- you don't have to stick with just one.
  324.  
  325.  
  326. Installation
  327.  
  328.      The Ultimate Language Tutor was written for the IBM PC, PC/XT, PC/AT,
  329.      PS/2, and compatibles.  It requires MS/PC-DOS 2.0 or above, and at least
  330.      512K on your machine, free ram should be slightly above 269K.
  331.  
  332.      Files
  333.  
  334.      The files listed below should be included with your shareware version, or
  335.      copy you receive:
  336.  
  337.      TEACHERS.EXE        This is the Shareware version of the Ultimate Language
  338.                          Teacher.
  339.  
  340.      TEACHER.CFG         This file contains configuration information and a
  341.                          copy of the registration sheet.  You may view/print
  342.                          this sheet from within the program.
  343.  
  344.      LIB?????.DAT        These are the data files or libraries used by the
  345.                          Ultimate Language Teacher.
  346.  
  347.      For registered users, your copy should include the above, plus:
  348.  
  349.      LIBBUILD.EXE        This is the library builder used to create
  350.                          LIB?????.DAT files.
  351.  
  352.      TEACHERR.EXE        This is the Registered version of the Ultimate
  353.                          Language Teacher.
  354. Execution                                                               Page 6
  355.  
  356.      The program was designed around the use of bar menus to allow the easiest
  357.      possible interface between user and program.  All menus include mouse
  358.      support if a mouse driver is loaded.
  359.  
  360.      MAIN MENU
  361.  
  362.      The main menu will include different selections depending upon whether you
  363.      are using the registered version or not.  
  364.  
  365.           Test         ->Test from the selected library.
  366.           Libraries    ->Libraries allow for other languages and more words
  367.           People       ->Allows for up to 3 people to "compete"
  368.           Register     ->Registration form and registration number
  369.           QUIT         ->Returns you to DOS or your menu program
  370.  
  371.      In order to elaborate on each selection, I will follow each of them to the
  372.      end and then come back on the others.  Therefore, here is a cross-
  373.      reference table to the beginning of other menu selections:
  374.  
  375.           TEST                          Page 6.
  376.           LIBRARIES                     Page 7.
  377.           PEOPLE                        Page 8.
  378.           REGISTER                      Page 9.
  379.  
  380.      TEST
  381.  
  382.      The test menu will open a new menu that should appear with the following
  383.      selections:
  384.  
  385.      NOTE:  If there are not enough words in an area to test you on, there will
  386.      be a message like:  Insufficient nouns in the library.
  387.  
  388.           Nouns          ->Test from the XXX nouns in the library.
  389.           Verbs          ->Test from the XXX verbs in the library.
  390.           Phrases        ->Test from the XXX phrases in the library.
  391.           Verb Conj.     ->Test from the XXX Conjugated Verbs in the library.
  392.           Miscellaneous  ->Test from the XXX Miscellaneous words in the
  393.           library.
  394.           MAIN MENU      ->Returns you to the main menu.
  395.  
  396.      When you select what area you would like to be tested on, you will be
  397.      asked the following questions:
  398.  
  399.               Would you like to test for a specific person (Y/N)?
  400.  
  401.      NOTE:  This question only appears if you have entered a person under the
  402.      people menu.  This will allow you to track scores during this session.
  403.  
  404.                  Would you like a multiple choice test (Y/N)?
  405. Execution (continued)                                                   Page 7
  406.  
  407.      If you select no you will have fill in the blank answers, otherwise you
  408.      will be presented with a list of 5 possible answers.  NOTE:  There are no
  409.      fill in the blanks under verb conjugation.
  410.  
  411.                    Would you like ENGLISH to XXXXXXX (Y/N)?
  412.  
  413.      If you select yes, the test will display the question in ENGLISH and ask
  414.      you for the foreign language answer.  Otherwise, this will be reversed.
  415.  
  416.      During testing, the screen will be divided into two major screens, the
  417.      QUIZ ENTRY SCREEN and the QUIZ RESULTS SCREEN.  The QUIZ ENTRY SCREEN on
  418.      the left will display the question and await your answer.  The QUIZ
  419.      RESULTS SCREEN will have information on the test so far; for instance,
  420.      number correct, number tested, percentage correct, average time per
  421.      answer, and time for last answer.  The information on amount of time for
  422.      testing is not recorded and placed there for your own convenience.
  423.  
  424.      Directly below these two screens will be two bar graphs.  The top graph
  425.      shows the amount of the library you have been tested on and the other
  426.      shows you the percentage correct.  If, for instance, you get the first
  427.      question correct, the bottom bar will be all the way across the screen and
  428.      the top bar will move proportional to the amount of the library that
  429.      question represents.
  430.  
  431.      Once testing is completed or if you press ESC before completing a test
  432.      sequence, a summary box will replace the two windows and two bar graphs. 
  433.      It will tell you how you have done and if you have completed the test.  At
  434.      this point, you can press enter or click the mouse on the phrase "Press
  435.      Enter to Continue".  You will be returned to the TEST MENU to select
  436.      another area for testing or return to the MAIN MENU.
  437.  
  438.  
  439. LIBRARIES
  440.  
  441.      If during testing, you decide that you want to use another library, you
  442.      should simply select LIBRARIES from the main menu.  A list of currently
  443.      accessible libraries will be displayed for you to select from.  Simply
  444.      move the high-lighted bar up or down and press enter when you are on the
  445.      library you want.  If the library you want is not displayed, you can use
  446.      the PgDn or PgUp keys to check for another screen.  If you are using a
  447.      mouse there will be two arrows on the border for moving the high-lighted
  448.      bar, or you may simply click on the library you want.  The library
  449.      function will not load more than 50 libraries, so if there is a library
  450.      you know should be loaded, check to make sure you don't have more than 50
  451.      libraries in one directory.  All library names must match the file mask
  452.      "LIB*.DAT", for instance LIBSPAN.DAT is OK, but LSPANISH.DAT is not.
  453. PEOPLE                                                                  Page 8
  454.  
  455.      The people selection will bring up another menu, something like this:
  456.  
  457.           Add a person        ->Add a person to the list
  458.           Remove a person     ->Remove a person from the list
  459.           See Scores          ->View current scores for all people
  460.           Graph Scores        ->Show a graph of the scores, comparing all
  461.           people
  462.           MAIN MENU           ->Return to main menu
  463.  
  464.  
  465. ADD A PERSON
  466.  
  467.      The program was designed to keep an internal table of the people testing
  468.      to record there results and to show them their results compared to others
  469.      currently using the program.  When you select ADD A PERSON, the menu will
  470.      be replaced by a box showing all of the names in the internal table.  It
  471.      will then ask you for a new person.  If you choose not to enter another
  472.      person, you can simply press ENTER or ESC to return to the PEOPLE MENU. 
  473.      If you enter a person, the person will be added to the internal table and
  474.      the names in the box will be updated.  Once you have entered the maximum
  475.      number of people, the PEOPLE menu will automatically return.  If you have
  476.      the maximum number of people already entered and try to enter another, a
  477.      message will appear informing you of the problem.  You must either remove
  478.      a person or continue testing with the people currently on the list.
  479.  
  480. REMOVE A PERSON
  481.  
  482.      As mentioned under ADD A PERSON, the internal table of people is limited
  483.      to a certain number.  Once this number is reached, you must remove a
  484.      person to add a person.  This area of the people menu will help you do
  485.      this.  When you select Remove a Person, a list of the people that are
  486.      currently on the list pops up, and you can select a person to remove. 
  487.      Press ESC if you don't want to remove a person.
  488.  
  489. SEE SCORES
  490.  
  491.      This will display the current scores for the people the computer knows
  492.      about.  Once you are done viewing, you can press ENTER to return to the
  493.      people menu.
  494.  
  495. GRAPH SCORES
  496.  
  497.      This is much like SEE SCORES; however, it will display the scores as a
  498.      graph.  Some people find this method easier for determining who is ahead. 
  499.      When you select this function, there will be a list of the people on the
  500.      left, and a box on the right with the current scores for nouns listed. 
  501.      You need to use the arrow keys at this point to display each person's
  502.      scores, or select Quit.
  503. REGISTER                                                                Page 9
  504.  
  505.      When you select register from the MAIN MENU, a box will come up displaying
  506.      a message that you can either print the registration form or display it on
  507.      screen.  Then it will ask if you would like the form printed.  If you
  508.      answer Yes, please make sure your printer is set up and has paper in it. 
  509.      The registration form is only one page and there shouldn't be any problems
  510.      with printing.  If you answer No, the registration form will be displayed
  511.      on screen in three separate screens; just press a key to see the next one. 
  512.      If you are copying down the form, please make sure that you copy
  513.      everything down exactly as you see it.  Then fill out the questions.  If
  514.      you don't feel like answering the questions about your system, that is
  515.      fine.  However, please feel free to make any comments or suggestions
  516.      anywhere on the sheet.  Also make sure to copy down the special
  517.      registration number.  The registration number tells us where your copy of
  518.      the Ultimate Language Tutor came from.
  519.  
  520.      Remember that registration will bring you an upgrade to the Registered
  521.      version of the program.  The registered version has all of the features
  522.      found in this copy and includes the following:
  523.  
  524.      1.   Database functions:  All of the tests for a specific person will be
  525.           recorded.  Any record can be easily removed if you decide you don't
  526.           want anyone to be able to see your initial scores.
  527.  
  528.  
  529.      2.   Reporting functions:  Any of the scores recorded in the database can
  530.           be viewed in a report.  Reporting is very flexible, output may be
  531.           redirected to either the screen, printer, or a file.  All reports may
  532.           be sorted by Name, Library, or Date.  All reports allow you to
  533.           "filter" out whatever you don't want on the report.  For example: 
  534.           You could have a report sorted by date with only a specific person
  535.           tested on a specific library with only completed tests from nouns,
  536.           verbs, and misc.
  537.  
  538.      3.   Information about all of the other Ultimate Software programs that
  539.           are currently available, as well as new ones as they are released.
  540.  
  541.      4.   Unlimited technical support:  We have a phone number you may call in
  542.           the event that you have any problems with this program.
  543.  
  544.  
  545.                  End of Ultimate Language Tutor Documentation